MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

Web Playground

Academy Endpoint

Interactive request form for this API endpoint.

Each card below maps directly to an API endpoint. Query, path, and request body fields are generated from OpenAPI.

Jump to endpoint

GET /web/academy/meta/version GET /web/academy/heroes/catalog GET /web/academy/roles GET /web/academy/equipment GET /web/academy/equipment/expanded GET /web/academy/spells GET /web/academy/emblems GET /web/academy/ranks GET /web/academy/ranks/{rank_id} GET /web/academy/recommended GET /web/academy/recommended/{recommended_id} GET /web/academy/heroes GET /web/academy/heroes/{hero_identifier}/stats GET /web/academy/heroes/{hero_identifier}/lane GET /web/academy/heroes/{hero_identifier}/win-rate/timeline GET /web/academy/heroes/{hero_identifier}/builds GET /web/academy/heroes/{hero_identifier}/counters GET /web/academy/heroes/{hero_identifier}/teammates GET /web/academy/heroes/{hero_identifier}/trends GET /web/academy/heroes/{hero_identifier}/recommended GET /web/academy/heroes/ratings GET /web/academy/heroes/ratings/{subject}

GET Hero Recommended Content

/web/academy/heroes/{hero_identifier}/recommended

Open Only This

Retrieve recommended content for a specific hero. Supports query parameters for pagination, sorting, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • order: Sort order for recommendation hotness or creation time. Allowed values: asc, desc.
  • lang: Language code for localized content (default: en).

The response includes hero recommended content data:

  • records: Array of recommended entries, each containing:
      • createdAt: Creation timestamp.
      • updatedAt: Last update timestamp.
      • data:
          • channels: Content channels (e.g., 'UGC', 'recommend').
          • type: Content type (e.g., 'ugc_hero').
          • state: Content state (e.g., 'release').
          • data:
              • hero: Hero metadata including:
                  • hero_id: Hero ID.
                  • hero_lane: Lane assignment.
                  • hero_tags: Array of tag IDs.
              • equips: Recommended equipment builds with IDs and descriptions.
              • emblems: Recommended emblem sets with IDs and descriptions.
              • spell: Recommended battle spell with ID and description.
              • cooperates: Cooperative hero synergies with descriptions and rates.
              • counters: Counter heroes with descriptions and rates.
              • dominants: Dominant strategies or tips.
              • recommend: General recommendation notes.
              • snapshot: Snapshot image URL.
              • game_version: Version reference.
              • language: Content language.
              • pages: Content sections (e.g., 'hero', 'spell', 'equip').
              • title: Guide or build title.
          • user: Author metadata including:
              • name: Author name.
              • avatar: Author avatar URL.
              • level: Author level.
              • roleId: Role ID.
              • zoneId: Zone ID.
          • dynamic: Engagement metrics:
              • views: Total views.
              • hot: Hotness score.
              • votes: Total votes.
              • views_by_4h_total_24h: Views in last 24h.
          • vote_all: Voting metadata:
              • target: Target content ID.
              • vote: Vote ID reference.

This endpoint is useful for:

  • Surfacing curated or community-recommended hero guides.
  • Providing builds, emblems, and strategies tailored to a hero.
  • Highlighting cooperative and counter hero recommendations.
  • Guiding players with contextual tips and shared experiences.
hero_identifier path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Required.

size query

Number of items per page. Minimum: 1.

index query

Page index for pagination. Minimum: 1.

order query
▾

Sort order for recommendation hotness and creation time.

lang query
▾

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/recommended